home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2000 #4 / Amiga Plus CD - 2000 - No. 4.iso / Tools / Patch / RemApollo / RemAPollo.doc.pl < prev    next >
Encoding:
Text File  |  2000-04-24  |  28.1 KB  |  648 lines
  1.                                 RemAPollo V1.4
  2.  
  3.                        Produkt Eccentric Creations (TM)
  4.  
  5.                  (c) Mikoîaj Caîusiïski 1998-2000. Freeware.
  6.  
  7.                              Instrukcja obsîugi.
  8.  
  9. Wstëp
  10. -----
  11.  
  12. RemAPollo - A1200 040\060 MMU Apollo Turboboard Remapper jest pakietem
  13. freeware (uûywanie go nie wymaga rejestracji ani ûadnych opîat), ale autor
  14. zastrzega sobie wszystkie prawa autorskie. Pakiet zostaî napisany pod wpîywem
  15. mojej rozpaczy, wynikajâcej z braku moûliwoôci podmiany Kickstartu przez
  16. uûytkowników kart Apollo. My, posiadacze tychûe kart byliômy w gorszej
  17. sytuacji, niû wîaôciciele kart typu Blizzard, którzy mogli w dziecinnie prosty
  18. sposób (ustawiajâc jednâ zworkë na karcie) "podmieniê" sobie ROM. My nie
  19. moûemy tego zrobiê - nasze karty nie posiadajâ takich zworek, dodatkowo nie
  20. byîo dotychczas programów umoûliwiajâcych nam takâ operacjë w sposób czysto
  21. programowy. Mam nadziejë, ûe ta nierównoôê zostanie niniejszym wyrównana przez
  22. RemAPollo.
  23.  
  24. Zwróê uwagë, ûe chociaû RemAPollo nie jest juû w fazie beta testów, to nie
  25. musi to wcale oznaczaê, ûe jest pozbawiony wszelkich bîëdów. Jeûeli wykryjesz
  26. jakiekolwiek nieprawidîowoôci w dziaîaniu programu, skontaktuj sië ze mnâ;
  27. szczegóîowe opisy bîëdów mile widziane. Mój adres znajdziesz w rozdziale
  28. "Autor". Ponadto upewnij sië, ûe uwaûnie przeczytaîeô të instrukcjë!
  29.  
  30. Rozpowszechnianie
  31. -----------------
  32.  
  33. Pakiet RemAPollo moûe byê swobodnie rozpowszechniany, przy uwzglëdnieniu
  34. poniûszych kryteriów:
  35.  
  36.  - Ûaden z plików, wchodzâcych w skîad pakietu nie moûe byê modyfikowany, ani
  37.    pominiëty.
  38.  
  39.  - Nie moûna pobieraê ûadnych opîat za pakiet, z wyjâtkiem kosztu noônika i
  40.    opîat manipulacyjnych.
  41.  
  42.  - Pakiet RemAPollo moûe byê doîâczany do zestawów darmowego oprogramowania,
  43.    ale nie moûe byê zamieszczany na komercyjnych pîytach CD-ROM (wîâczajâc w
  44.    to pîyty doîâczane do czasopism tzw. coverdyski). Jeûeli chesz zamieôciê
  45.    ten pakiet na swoim CD-ROMie musisz najpierw zwróciê sië do mnie o
  46.    wyraûenie zgody. Powyûsze nie dotyczy pîyt AminetCD; Administrator Aminetu,
  47.    Urban MÜller, ma mojâ zgodë na umieszczanie pakietu RemAPollo na tychûe
  48.    pîytach.
  49.  
  50.  - Pakiet RemAPollo nie moûe byê doîâczany do jakiegokolwiek komercyjnego
  51.    produktu, bez mojej pisemnej zgody.
  52.  
  53. Ostrzeûenie
  54. -----------
  55.  
  56. UÛYWASZ PLIKÓW, WCHODZÂCYCH W SKÎAD PAKIETU RemAPollo CAÎKOWICIE NA WÎASNE
  57. RYZYKO. NIE PONOSZË ÛADNEJ ODPOWIEDZIALNOÔCI ZA SZKODY SPOWODOWANE
  58. UÛYTKOWANIEM TEGO PAKIETU!
  59.  
  60. Do czego to wîaôciwie sîuûy?
  61. ----------------------------
  62.  
  63. RemAPollo jest pakietem programów stworzonych dla uûytkowników komputera Amiga
  64. 1200, wyposaûonego w kartë turbo Apollo 040/060. W jego skîad wchodzi kilka
  65. plików sîuûâcych do podmieniania Kickstartu - czëôci systemu operacyjnego
  66. Amigi, znajdujâcej sië w ROMie. Moûesz przenieôê Kickstart, który masz
  67. zapisany w ROMie do szybkiej pamiëci, bâdú teû uûyê zupeînie innej wersji
  68. Kickstartu (szczególnie przydatne, gdy jesteô programistâ). Wiëcej szczegóîów
  69. w rozdziale "Korzystanie z pakietu".
  70.  
  71. Pliki pakietu
  72. -------------
  73.  
  74. Pakiet RemAPollo skîada sië z nastëpujâcych plików
  75.  
  76. - 68060.pch - îatka uaktualniajâca bibliotekë 68060 w wersji 60.02 do 60.10
  77. - Converter - komenda umoûliwiajâca konwersjë moduîów BlizKicka (typu
  78.   extresbuf) na format zrozumiaîy dla RemAPollo.
  79. - CopyIDEfixPrefs - programik dla uûytkowników pakietu IDEfix - sîuûy do
  80.   kopiowania preferencji z zewnëtrznego pliku do pliku komendy IDEfix.
  81.   Powinien byê uûyty przez uûytkowników chcâcych zaîadowaê IDEfixa poprzez
  82.   opcjë MODULES mapera
  83. - DRAP - Apollo Remapper Deallocator
  84. - FakeLOCAL - ta komenda ustawia atrybut LOCAL (na Kickstarcie 3.x równieû bit
  85.   KICK) dla pamiëci fast karty Apollo. Dziëki temu wiëkszoôê programów
  86.   rezydentnych zostaje zainstalowana w pamiëci fast zamiast chip. UWAGA!
  87.   Poniewaû ustawienie tych bitów przez uûytkownika jest nielegalne (powinna to
  88.   byê wyîâcznie domena systemu), program ten jest przeznaczony tylko dla
  89.   zaawansowanych uûytkowników! Uûywaj tylko razem z programem RemAPollo i
  90.   tylko jeôli wiesz, co robisz!
  91. - KingCON-handler.pch - îatka na KingCON-handler 1.3, w wersji 020+,
  92.   umoûliwiajâca jego rezydentne zaîadowanie (dziëki czemu caîkowicie zastëpuje
  93.   on systemowy con-handler)
  94. - KReader - krótka komenda do zgrywania Kicstartu do pliku ram:Kickstart
  95. - LoadResident - komenda CLI, która sîuûy do dodawania moduîów rezydentnych
  96.   bez koniecznoôci ponownego uruchamiania programu RemAPollo. Moûna podaê
  97.   dwa parametry: FORCEFAST (sîuûy do wymuszenia alokacji w pamiëci fast; moûe
  98.   byê uûyty do sprawdzenia, czy podane moduîy mogâ zostaê umieszczone w
  99.   szybkiej pamiëci) oraz REBOOT (resetuje komputer po 1 sekundzie)
  100. - Modules/noclick - uaktualniona wersja moduîu BlizKicka, który sîuûy do
  101.   wyîâczania "klikania" stacji dysków
  102. - Modules/noclick.s - kod úródîowy do tego moduîu
  103. - patch - programik do aktualizacji biblioteki 6804(6)0
  104. - RemAPollo - gîówny program remapujâcy
  105. - RemAPollo.doc - angielska wersja dokumentacji
  106. - RemAPollo.doc.info
  107. - RemAPollo.doc.pl - niniejszy tekst
  108. - RemAPollo.doc.pl.info
  109. - RemAPollo.info - fajna ikonka
  110. - RemAPollo.readme - krótki opis dla Aminetu
  111. - Reset - programik resetujâcy
  112. - RUX - OS3.5 ROM Update eXtractor - komenda ulatwiajaca instalacje systemu
  113.   3.5, z zachowaniem jednego resetu na starcie komputera (patrz teû rozdziaî
  114.   "Informacje dodatkowe")
  115.  
  116. Prawa autorskie
  117. ---------------
  118.  
  119. Amiga, AmigaOS and Kickstart - Copyright © 1985-1999 Amiga International,
  120. Inc.
  121. BlizKick - Copyright © 1996-1999 PitPlane Productions.
  122. Fusion - Copyright ©1997 By Jim Drew & Microcode Solutions
  123. IDEfix - Copyright 1993 - 1999 Elaborate Bytes, Oliver Kastl.
  124. KingCON-handler - Copyright © 1993,1994 David Larsson
  125. RemAPollo - Copyright © 1998-1999 Mikoîaj Caîusiïski.
  126. ShapeShifter - © Copyright 1993-1999 Christian Bauer.
  127. spatch - Copyright © 1992 SAS Institute, Inc.
  128.  
  129. Wymagania
  130. ---------
  131.  
  132. Dla poprawnego dziaîania pakietu sâ wymagane: 
  133.  
  134. - komputer Amiga 1200 lub 4000 (patrz rozdziaî: "Bîëdy")
  135.  
  136. - przynajmniej wersja 2.0 (V36) systemu operacyjnego (to chyba nie jest
  137.   problem :-)
  138.  
  139. - karta turbo Apollo 040 lub 060 (procesor musi posiadaê sprawny MMU),
  140.   wyposaûona w przynajmniej 1 MB pamiëci fast
  141.  
  142. - oryginalna biblioteka 040.library pochodzâca z Commodore w wersjach 37.10
  143.   lub 37.30 (lub 44.2 z OS3.5), jeûeli uûywasz procesora 68040 albo biblioteka
  144.   060.library doîâczana do karty turbo (obecnie program wspóîpracuje tylko z
  145.   wersjâ 60.10), jeûeli uûywasz procesora 68060.
  146.  
  147.  
  148. Instalacja
  149. ----------
  150.  
  151. Instalacja, jakkolwiek prosta, skîada sië z kilku czynnoôci, które powinny byê
  152. wykonane starannie i uwaûnie, w przeciwnym razie system prawie na pewno bëdzie
  153. sprawiaî problemy. Poniewaû RemAPollo nie jest przeznaczony dla
  154. niedoôwiadczonych uûytkowników, w pakiecie nie ma skryptu instalacyjnego -
  155. caîâ pracë musisz wykonaê rëcznie.
  156.  
  157.                                       1.
  158.  
  159. Najpierw - to bardzo waûne - powinieneô zaktualizowaê plik 040(060).library. W
  160. archiwum z programem znajdziesz specjalny program "patch" do tego celu. Jeûeli
  161. Twoja 040(060).library znajduje sië w katalogu LIBS: i nie zostaîa spakowana,
  162. wystarczy jedynie uruchomiê program "patch" bez ûadnych parametrów. Program
  163. poinformuje Cië o wyniku swojej pracy, niestety tylko po angielsku. UWAGA! W
  164. przypadku procesora 68040 upewnij sië, ûe uûywana przez Ciebie 040.library
  165. pochodzi z Commodore; jeûeli wykorzystujesz bibliotekë pochodzâcâ z innych
  166. úródeî (np. z Phase5) musisz z niej zrezygnowaê. W szczególnoôci remaper nie
  167. bëdzie wspóîpracowaî z bibliotekami Phase5; ich uûywanie nie wpîywa na lepsze
  168. funkcjonowanie kart Apollo.
  169.  
  170. Jeôli Twoja biblioteka jest spakowana, najpierw rozpakuj jâ, a nastëpnie
  171. wywoîaj program "patch" podajâc ôcieûkë dostëpu do niej. Po skoïczonej
  172. operacji moûesz spakowaê bibliotekë ponownie.
  173.  
  174. Powyûsza czynnoôê jest ABSOLUTNIE konieczna, dla prawidîowej pracy systemu z
  175. podmienionym Kickstartem. Twoja Amiga moûe dziaîaê poprawnie bez dokonywania
  176. zmian w pliku 040(060).library, ale nie wprowadzajâc ich sam prosisz sië o
  177. kîopoty; za którymô razem system moûe sië "zawiesiê". Jeûeli chcesz dowiedzieê
  178. sië czegoô wiëcej o zmianach wykonywanych przez program "patch" przeczytaj
  179. rozdiaî "Informacje dodatkowe".
  180.  
  181. Niektóre starsze wersje kart Apollo z procesorem 060, posiadajâ doîâczonâ
  182. bibliotekë 68060 w wersji 60.02, z którâ nie wspóîpracuje programik "patch"
  183. (który wymaga biblioteki w wersji 60.10). Specjalnie dla uûytkowników takich
  184. kart, doîâczyîem specjalnâ îatkë uaktualniajâcâ 68060.library do wersji 60.10.
  185. Aby jâ wykorzystaê, uûyj powszechnie dostëpnego programiku "spatch".
  186.  
  187.                                       2.
  188.  
  189. Po zakoïczeniu operacji uaktualniania biblioteki powinieneô skopiowaê program
  190. DRAP (Apollo Remapper Deallocator) do katalogu C:. Do wersji 1.11 wîâcznie,
  191. wywoîanie DRAPa musiaîo nastâpiê po komendzie SetPatch; poczâwszy od wersji
  192. 1.12 nie jest to konieczne. Obecnie zaleca sië umieszczenie DRAPa jako
  193. pierwsza komenda w startupie. Odpowiedni fragment Twojego startup-sequence
  194. moûe wyglâdaê tak:
  195.  
  196. ...
  197. DRAP
  198. If WARN
  199. RemAPollo MAC QUIET
  200. EndIf
  201. SetPatch QUIET
  202. ...
  203.  
  204. Stosowanie tego programiku nie jest wymagane dla poprawnego funkcjonowania
  205. relokacji, ale jego uûycie jest ze wszech miar polecane. Jego dziaîanie polega
  206. m.in. na zwolnieniu pamiëci alokowanej przez remaper (dokîadnie 67712
  207. bajtów) i doprowadzeniu systemu do bardziej efektywnego i stabilnego stanu.
  208. Jeûeli zamierzasz korzystaê z funkcji MAC (patrz rozdziaî "Korzystanie z
  209. pakietu") ten program *MUSI* zostaê uruchomiony, w przeciwnym razie emulator
  210. "zawiesi" sië. Uûywanie DRAPa przyspieszy teû nieco pracë systemu, poniewaû
  211. przenosi pierwszâ stronë pamiëci (pierwsze 4kb) z wooolnej pamiëci chip do
  212. pamiëci fast. Wreszcie, zabezpieczy on zmapowany Kickstart przed zapisem.
  213. Moûesz umieôciê DRAPa w startup-sequence na staîe - w przypadku nie wykrycia
  214. relokacji nie robi on nic, z wyjâtkiem ustawienia kodu wyjôciowego (RC) na 5.
  215.  
  216. Od wersji 1.8 DRAPa istnieje moûliwoôê pewnej jego konfiguracji, jednak
  217. zalecane jest wywoîywanie DRAPa tak, jak dotychczas (bez ûadnych parametrów).
  218. Nowe parametry to: ND (lub NODEALLOC) oraz RH (lub RESTOREHANDLER).
  219.  
  220. Pierwszy wstrzymuje dealokacje pamiëci (67720 bajtów) uûywanej na tabele MMU.
  221. Tabele te nie sâ potrzebne, jak tylko 68040.library zostanie zainstalowana w
  222. systemie, wiëc w wiëkszoôci przypadków nie powinno sië wywoîywaê tego
  223. przeîâcznika. Jeôli jednak chcesz korzystaê ze statram.device (SDx:) lub masz
  224. problemy ze úle napisanymi programami rezydentnymi (np. SIMBug), powinieneô
  225. wîâczyê NODEALLOC. Bëdziesz miaî mniej pamiëci (67720 bajtów) ale SD0 bëdzie
  226. pracowaê jak powinno.
  227.  
  228. Drugi parametr (RESTOREHANDLER) wymusza odtworzenie oryginalnej wartoôci
  229. wektora Bus-Error, tak, jak w poprzedniej wersji remapera. Nie jest to
  230. polecane, poniewaû spowoduje zawieszenie sië komputera (o ile nie jest
  231. uruchomiony Enforcer) po zapisie w obszar ROMu.
  232.  
  233. Od wersji 1.12 zostaîy wprowadzone drobne zmiany w kodzie inicjalizacyjnym
  234. DRAPa, dziëki czemu nie musi on juû byê uruchamiany po komendzie SetPatch -
  235. program teraz sam otwiera 68040\060.library. Wprowadzono teû nowy parametr NR
  236. (NOREMAP), który wyîâcza domyôlne remapowanie tzw. zerowej strony pamiëci z
  237. chipu do fastu. Przy okazji poprawiono teû kompatybilnoôê tej operacji.
  238. Dodatkowe informacje moûesz znaleúê w sekcji Bîëdy. 
  239.  
  240.                                       3.
  241.  
  242. Kiedy powyûsze punkty zostanâ zrealizowane moûesz uûyê gîównego programu z
  243. pakietu (patrz rozdziaî "Korzystanie z pakietu").
  244.  
  245. Relokacja pozostanie aktywna tak dîugo, jak dîugo nie zostanâ naruszone: baza
  246. biblioteki exec ani wektor ColdCapture. Aby pozbyê sië jej z pamiëci uûyj
  247. zaîâczonego w pakiecie programu "Reset" z opcjâ HARD. Program ten wyczyôci
  248. lokacjë 4, usuwajâc z systemu wszelkie rezydenty.
  249.  
  250. Korzystanie z pakietu
  251. ---------------------
  252.  
  253. Gîówny program pakietu RemAPollo (o tej samej nazwie) moûe byê uruchomiony
  254. zarówno z CLI jak i z Workbencha. Tooltypy sâ praktycznie identyczne z
  255. parametrami CLI, w zwiâzku z czym omówimy tylko te ostatnie.
  256.  
  257. Standardowa skîadnia (uzyskiwania poprzez wpisanie "?" jako parametru) wyglâda
  258. tak:
  259.  
  260. KICKFILE,MAC/S,NF=NOPAGEFIX/S,IMJ/S,FORCE/S,QUIET/S,USE=USEKICKPTRS/S,MODULES/
  261. K/M/F:
  262.  
  263. Ûaden z parametrów nie jest wymagany. Jeûeli nie podasz wcale argumentów
  264. aktualny ROM zostanie zmapowany, a komputer wykona reset. Amiga zgîosi sië z
  265. tym samym Kickstartem co w ROMie, z jednâ niezwykle uûytecznâ róûnicâ: pamiëê
  266. fast jest przyîâczana w bardzo wczesnej fazie startu systemu (odpada
  267. koniecznoôê uûywania programów typu FastExec). Dziëki temu moûesz takûe
  268. zakîadaê dyski wirtualne RAD w pamiëci fast!
  269.  
  270. KICKFILE - ten parametr jest uûywany do zlokalizowania pliku z obrazem
  271. Kickstartu, którego chcesz uûywaê. Obsîugiwane sâ tylko Kickstarty 512kB,
  272. zawierajâce nagîówek $1114 lub 256KB z nagîówkiem $1111 i poprawnâ sumë
  273. kontrolnâ. Od wersji 1.4 RemAPollo wspóîpracuje z Kickstartami 1.x (256kB).
  274.  
  275. Od wersji 0.994 RemAPollo moûe uzywaê spakowanych plików z Kickstartem - w tym
  276. celu musisz zainstalowaê xfdmaster.library.
  277.  
  278. MAC - uûyj tej opcji, jeûeli korzystasz z programowego emulatora komputerów
  279. Macintosh. Spowoduje ona rezerwacjë pierwszych 16kB pamiëci chip, czego
  280. wymagajâ te programy. Nie musisz juû uûywaê programów typu RsrvCold, RsrvWarm
  281. czy PrepareEmul w swoim startup-sequence. Nie zapomnij wywoîaê programu "DRAP"
  282. zaraz po SetPatchu!
  283.  
  284. NF lub NOPAGEFIX - ta opcja ma sens tylko przy Kickstarcie 2.x; w wersjach 3.x
  285. jest ignorowana. Jest uûywana do wyîâczenia poprawki w systemie, dotyczâcej
  286. pierwszej strony pamiëci, a dokonywanej automatycznie przez remapera. Na
  287. Kickstartach 2.x pamiëê chip jest przyîâczana do systemu od lokacji $400.
  288. Poniewaû MMU procesorów 040 i 060 moûe pracowaê z najmniejszâ rozdzielczoôciâ
  289. 4kB, lepiej jest, aby pamiëê byîa odpowiednio do tego wyrównana (czyli
  290. zaczynaîa sië od adresu $1000). Aby tego dokonaê maper poprawia procedurë
  291. inicjalizacji systemu; poczâwszy od Kickstartu 3.x ta poprawka nie jest juû
  292. potrzebna. Jeôli z jakiegoô powodu nie chcesz zmieniaê oryginalnego zachowania
  293. sië systemu 2.x przy przyîâczaniu pamiëci chip uûyj opcji NOPAGEFIX. Parametr
  294. ten nic nie robi w przypadku uûycia opcji MAC.
  295.  
  296. FORCE - uûywany jeûeli relokacja jest juû aktywna i chcesz wymusiê ponowne
  297. uûycie mapera. Normalnie remaper nie bëdzie staraî sië dokonaê relokacji,
  298. jeôli stwierdzi takowâ w pamiëci (umoûliwia to stosowanie mapera w
  299. startup-sequence bez ciâgîych resetów komputera).
  300.  
  301. QUIET - idealna opcja dla chcâcych wykorzystywaê mapera na staîe (w
  302. startupie); powoduje wyîâczenie wypisywania tekstów i skraca oczekiwanie na
  303. reset komputera.
  304.  
  305. ---> Poczâwszy od wersji 1.12, zostaîa dodana nowa opcja: IMJ; jej podanie
  306. spowoduje, ûe maper bëdzie ignorowaî zworkë MEM, która umoûliwia odîâczenie
  307. pamiëci fast umieszczonej na karcie.
  308.  
  309. O ile nie wybraîeô opcji QUIET, moûesz przerwaê proces mapowania wciskajâc
  310. jednoczeônie klawisze "control" i "c" (CTRL-C).
  311.  
  312. *****************************************************************************
  313. **** UWAGA! PONIÛSZY AKAPIT JEST PRZEZNACZONY DLA ZAAWANSOWANYCH! UWAGA! ****
  314. *****************************************************************************
  315.  
  316. ---> Poczâwszy od wersji 0.980ß, zostaîa dodana nowa opcja: MODULES
  317.  
  318. MODULES - ten parametr okreôla lokacjë plików, które majâ byê umieszczone w
  319. pamiëci jako rezydentne razem z mapowanym Kickstartem. Liczba tych plików jest
  320. ograniczona jedynie wielkoôciâ dostëpnej pamiëci (oraz maksymalnâ dîugoôciâ
  321. linii rozkazowej). Moduîem rezydentnym moûe byê kaûdy plik, który posiada
  322. strukturë resident (na przykîad biblioteka czy filesystem). Moûna teû
  323. skorzystaê z tej opcji, aby zaîadowaê IDEFix'a. Uwaga! - opcja ta MUSI byê
  324. podana jako *ostatnia* w linii rozkazowej!
  325.  
  326. Poczâwszy od wersji 0.996 moûliwe jest wykorzystanie moduîów doîâczanych do
  327. programu BlizKick! Moduîy te wystëpujâ w dwóch postaciach  - jako tzw. îatki
  328. (patch) lub jako rezydenty (extresbuf). Te pierwsze mogâ byê uûywane
  329. bezpoôrednio jak zwykîe moduîy, natomiast pozostaîe naleûy skonwertowaê. W tym
  330. celu uûyj doîâczonego programiku "Converter".
  331.  
  332. Od wersji 1.2 podawanie za kaûdym razem peînych ôcieûek do moduîów leûâcych w
  333. tym samym katalogu nie jest juû konieczne. Zaîóûmy, ûe chcesz zaîadowaê trzy
  334. moduîy z katalogu DEVS:Mods/. W starszych wersjach, naleûaîoby napisaê tak:
  335.  
  336. "...MODULES DEVS:Mods/noclick DEVS:Mods/FixMath404 DEVS:Mods/ramlibstack"
  337.  
  338. Poczâwszy od wersji 1.2 wystarczy podaê ôcieûkë tylko za pierwszym razem:
  339.  
  340. "RemAPollo MODULES DEVS:Mods/noclick FixMath404 ramlibstack"
  341.  
  342. ---> Poczâwszy od wersji 0.991ß, zostaîa dodana nowa opcja: USEKICKPTRS
  343.  
  344. USE (lub USEKICKPTRS) - ten parametr zmusza remapera do uûycia bieûâcej listy
  345. rezydentów KickTag i KickMem. Dziëki temu moûliwe jest uûycie innych programów
  346. rezydentnych wymagajâcych resetu, a mimo to nadal mieê tylko jeden reset na
  347. starcie. Aby to osiâgnâê, dodatkowe programy instalujâce sië rezydentnie
  348. powinny byê uruchomione PRZED remaperem i powinny mieê zablokowanâ opcje
  349. wykonania restartu komputera. Np. jeôli uûywasz programu BootControl,
  350. napisanego przez Olivera Kastla i chciaîbyô mieê tylko jeden reset na starcie,
  351. Twój startup powinien wyglâdaê tak:
  352.  
  353. BootControl INSTALL        ;UWAGA: nie uûywaj opcji BOOT!!!
  354. RemAPollo DEVS:Kick3.1 MAC QUIET USE    ;dziëki USE maper "widzi" BootControl
  355. SetPatch QUIET
  356. DRAP
  357. ...
  358.  
  359. Zwróê uwagë, ûe wszystkie programiki rezydentne zainstalowane w powyûszy
  360. sposób, zostanâ zaîadowane do pamiëci typu LOCAL, co na wiëkszoôci systemów
  361. oznacza chip. Aby to ominâê, napisaîem programik FakeLOCAL. Powinien on byê
  362. umieszczony jako pierwszy w startup-sequence - powyûszy przykîad bëdzie wiëc
  363. wyglâdaî nastëpujâco:
  364.  
  365. FakeLOCAL
  366. BootControl INSTALL        ;UWAGA: nie uûywaj opcji BOOT!!!
  367. RemAPollo DEVS:Kick3.1 MAC QUIET USE    ;dziëki USE maper "widzi" BootControl
  368. SetPatch QUIET
  369. DRAP
  370. ...
  371.  
  372. Teraz BootControl zostanie zaîadowany do pamiëci fast karty.
  373.  
  374. UWAGA: programik FakeLOCAL jest napisany niezgodnie z systemem (stanowi tzw.
  375. hack) i powinien byê wywoîywany tylko, jeôli przed resetem zostanie uûyty
  376. takûe RemAPollo! Jeôli nie rozumiesz znaczenia bitów LOCAL i KICK - lepiej nie
  377. uûywaj tego programiku!!!
  378.  
  379. *****************************************************************************
  380. *****************************************************************************
  381. *****************************************************************************
  382.  
  383.  
  384. Jeûeli potrzebny Ci przykîad, oto jak wyglâdajâ pierwsze linijki mojego
  385. startupu:
  386.  
  387. DRAP
  388. If WARN
  389. FakeLOCAL    ;uûywam tego TYLKO ze wzgîëdu na MountCD îadowany niûej!
  390. MountCD CD0 QUIET
  391. RemAPollo MAC QUIET USE MODULES C:IDEfix L:KingCON-handler FastFileSystem
  392. EndIf
  393. SetPatch QUIET
  394.  
  395. Mam Kickstart 3.1 w ROMie, wiëc nie muszë podawaê nazwy pliku. Jeôli uûywasz
  396. Kickstartu 3.0, powinieneô wpisaê coô w tym stylu:
  397.  
  398. RemAPollo DEVS:Kickstart3.1 MAC QUIET c:IDEFix l:FastFileSystem
  399.  
  400. Oczywiôcie, zakîadam ûe posiadasz odpowiedni plik w DEVS:.
  401.  
  402. Informacje dodatkowe
  403. --------------------
  404.  
  405. Rezydentny kod remapera jest zabezpieczony sumâ kontrolnâ aby zapewniê
  406. wîaôciwy start komputera - jeôli zostanie wykryta jakakolwiek zmiana w tym
  407. kodzie, program ustawi ekran na czerwono i zresetuje Amigë.
  408.  
  409. Maper korzysta z wektora ColdCapture, aby przetrwaê pomiëdzy resetami, wiëc
  410. nie powinieneô uûywaê ûadnych programów posîugujâcych sië nim. Dodatkowo jest
  411. równieû podmieniany wektor bus error procesora ($00000008) i powinien pozostaê
  412. niezmieniony, dopóki nie zostanie zainicjalizowana 040(060).library, co
  413. normalnie wykonuje SetPatch. Dopiero po tym powinieneô uruchomiê program DRAP,
  414. aby przywróciê oryginalnâ postaê tego wektora. Weú powyûsze pod uwagë podczas
  415. sprawdzania systemu programem antywirusowym.
  416.  
  417. Aby zmapowaê Kickstart, RemAPollo musi zbudowaê tabele MMU, co zajmuje pamiëê.
  418. Staraîem sië ograniczyê jej wielkoôê do niezbëdnego minimum, w zwiâzku z czym
  419. maper uûywa 8 kB tablic MMU. Niestety takie rozwiâzanie powoduje konflikt ze
  420. sposobem, w jaki biblioteki 040.library i 060.library instalujâ swoje 4 kB
  421. tablice. Nie wyîâczajâ one MMU przed zaîadowaniem tzw. root pointerów co
  422. prowadzi do nieprzewidywalnych reakcji systemu. Spójrz na odnoôny fragment
  423. kodu 040.library w wersji 37.30:
  424.  
  425. (wejôcie w të procedurë nastëpuje z wîâczonym MMU, ustawionym na tryb 8k)
  426.  
  427.     ori.w    #$700,SR
  428.     pflusha
  429.     move.l    (A0)+,D0
  430.     movec    D0,URP        ;!!! URP wskazuje na 4k tablice!!!
  431.     move.l    (A0)+,D0
  432.     movec    D0,SRP        ;!!! SRP wskazuje na 4k tablice!!! - BUUUM!
  433.     move.l    (A0)+,D0
  434.     movec    D0,TC        ;MMU zostaje przeîâczony na tryb 4k, trochë póúno...
  435.     pflusha
  436.     moveq    #0,D0
  437.     movec    D0,ITT0
  438.     movec    D0,ITT1
  439.     movec    D0,DTT0
  440.     movec    D0,DTT1
  441.     rte
  442.  
  443. Aby ta procedura dziaîaîa naleûy dodaê nastëpujâcy kod:
  444.  
  445.     ori.w    #$700,SR
  446.     moveq    #0,d0
  447.     movec    d0,TC        ;wyîâcz MMU
  448.     pflusha
  449.  
  450. ... i to wîaônie robi program "patch".
  451.  
  452. UWAGA: Jeûeli chcesz uûywaê Kickstartu z pliku, upewnij sië, ûe posiadasz
  453. wîaôciwâ jego wersjë, przystosowanâ do pracy z Twoim komputerem. Np. pliki
  454. Kickstartów, pochodzâce z A4000 (o wersjach 40.7x) nie bëdâ dziaîaîy poprawnie
  455. na A1200!
  456.  
  457.                                      ***
  458.  
  459. Uûytkownicy OS3.5, czytajcie:
  460.  
  461. Wielu z Was zapewne zastanawiaîo sië czy RemAPollo bëdzie wspóîpracowaî z
  462. systemem 3.5. Bez obaw: nie ma problemów. Wszystkie wersje pakietu sâ zgodne z
  463. najnowszâ aktualizacjâ AmigaOS; nie powinno byê równieû problemów z
  464. ewentualnymi przyszîymi poprawkami systemu operacyjnego. Jednakûe bieûâca
  465. wersja 1.3 pakietu remapera idzie nieco dalej w uîatwieniach przy instalacji
  466. systemu 3.5. W tym celu zostaî doîâczony specjalny programik "RUX", który
  467. sîuûy do "wyciâniëcia" rezydentnych modulow z pliku 'AmigaOS ROM Update'
  468. (znajdujâcego sië zwykle w DEVS:). Dziëki temu powodujâca drugi reset
  469. instalacja tych moduîów przez SetPatch, staje sië zbëdna. RUX reaguje na
  470. nastëpujâce parametry:
  471.  
  472. FILE,A600/S,A1200/S,A3000/S,A4000I/S,A4000S/S
  473.  
  474. FILE - wskazuje na plik 'AmigaOS ROM Update' (domyôlnie szukany w DEVS:)
  475.  
  476. Pozostaîe opcje okreôlajâ typ komputera, dla którego majâ byê przeznaczone
  477. "wyciâgane" moduîy:
  478.  
  479. A600 - raczej nie bëdziesz uûywaê tego przeîâcznika, gdyû "produkuje" on
  480.        moduîy przeznaczone dla procesora 68000
  481. A1200 - przewaûnie bëdziesz uûywaê tego
  482. A3000 - dla Amigi 3000
  483. A4000I - dla Amigi 4000 jeôli uûywasz tylko wbudowanego interfejsu IDE
  484. A4000S - dla Amigi 4000T z kontrolerem SCSI
  485.  
  486. Zatem po dokonanej instalacji przy uûyciu instalera z pîyty, moûesz dokonaê
  487. nastëpujâcych korekt:
  488.  
  489. 1. w katalogu LIBS: utwórz jakiô katalog (np. OS3.5)
  490. 2. przenieô z LIBS: do tego katalogu biblioteki workbench i icon
  491. 3. pamiëtaj aby usunâc te biblioteki z LIBS: (to waûne!)
  492. 4. zakîadajâc, ûe jesteô posiadaczem A1200, a plik "AmigaOS ROM Update"
  493. znajduje sië w DEVS:, otwórz okienko shella, zmieï katalog bieûâcy na
  494. LIBS:OS3.5/ i wpisz "RUX A1200"
  495. 5. stworzone zostanâ 3 pliki o nazwach: OS_Module1 OS_Module2 i OS_Module3 -
  496. sâ to rezydentne moduîy, które naleûy podaê przy opcji MODULES mapera
  497. 6. usuï plik "AmigaOS ROM Update" z DEVS: (zalecane) lub uûyj opcji
  498. NOROMUPDATE SetPatcha
  499.  
  500. Poczâtek Twojego startup-sequence powinien przypominaê coô takiego (oczywiôcie
  501. dostosuj to do swojej konfiguracji i upodobaï):
  502.  
  503. DRAP
  504. If WARN
  505. ;--------- to poniûej oczywiôcie w jednej linii
  506. RemAPollo DEVS:Kick3.1 MAC QUIET MODULES LIBS:OS3.5/OS_Module1 OS_Module2
  507. OS_Module3 workbench.library icon.library
  508. ;---------
  509. EndIf
  510. SetPatch QUIET NOROMUPDATE
  511. ...
  512.  
  513. Zazwyczaj moûesz opuôciê pierwszy moduî (OS_Module1), a w przypadku, gdy
  514. uûywasz teû IDEfixa lub FastATA, rownieû opuôê scsi.device. Prawdziwâ nazwë i
  515. funkcjë danego moduîu moûesz odczytaê z jego komentarza.
  516.  
  517. Dziëki takiej instalacji, unikniesz dwukrotnego resetu przy "zimnym" starcie
  518. komputera.
  519.  
  520. Bîëdy
  521. -----
  522.  
  523. Ramdysk sterowany przez statram.device (SDx:) nie bëdzie pracowaî poprawnie na
  524. domyôlnej konfiguracji pakietu RemAPollo. Aby to zmieniê, wywoîaj DRAPa z
  525. opcjâ "ND".
  526.  
  527. OXYPatcher nie instaluje poprawnie swojego portu na wiëkszoôci systemów. Nie
  528. jest to moja wina - OXYPatcher jest úle napisany.
  529.  
  530. Poczâwszy od wersji 119.11 (3.1) programu IDEfix, autor zmieniî koncepjë
  531. zapisu preferencji. Sâ one teraz zapisywane do osobnego pliku, co sprawia, ûe
  532. îadujâc IDEfixa opcjâ MODULES, przestaje on widzieê swoje preferencje. Uûyj
  533. programiku CopyIDEfixPrefs, aby zapisaê preferencje wewnâtrz IDEfixa.
  534.  
  535. Jeôli jesteô posiadaczem Amigi 4000 musisz zostawiê puste pierwsze gniazdo
  536. pamiëci na karcie; w przeciwnym wypadku maper nie bëdzie dziaîaê!
  537.  
  538. Otrzymaîem kilka raportów wskazujâcych na problemy z pewnymi starszymi grami
  539. na systemie z aktywnym RemAPollo. Dotyczyîo to gîównie tzw. gier NDOS, które
  540. sâ obecnie licznie "fixowane" do pracy z lepszymi procesorami i wyposaûane w
  541. loadery z twardego dysku. Próba uruchomienia niektórych gier tego typu
  542. owocowaîa problemami z grafikâ lub wrëcz powodowaîa zawieszenie sië komputera.
  543. Powyûsza sytuacja byîa spowodowana przez programik DRAP, który domyôlnie
  544. przenosiî tzw. stronë zerowâ pamiëci chip (pierwsze 4 lub 16kb w przypadku
  545. uûycia opcji MAC) do szybkiej pamiëci karty. Mówiâc szczerze, nie powinno to
  546. powodowaê ûadnych problemów, poniewaû kaûdy program napisany zgodnie z
  547. wytycznymi byîego Commodore, nie powinien uûywaê niezaalokowanej pamiëci.
  548. Niestety, w praktyce róûnie to bywa - dlatego postanowiîem zmieniê nieco
  549. sposób przeprowadzenia tego mapowania. Najpierw spróbuj pracy z nowym DRAPem,
  550. a jeôli to nie pomoûe, uûyj jego nowej opcji NR (NOREMAP), która spowoduje
  551. caîkowite wyîaczenie przenoszenia pierwszej strony chipu do fastu. Zwróê
  552. jednak uwagë, ûe po uûyciu Fusiona (emulatora Macintosha na Amigë) znów
  553. bëdziesz miaî te same problemy z uruchomieniem tych starych gier, poniewaû
  554. Fusion wykonuje to mapowanie we wîasnym zakresie. Dotyczy to tak pracy z
  555. RemAPollo jak i bez niego.
  556.  
  557.  
  558. Historia
  559. --------
  560.  
  561. V0.1ALFA - (??.9.98) - wersje wewnëtrzne tylko do wîasnego uûytku
  562.  
  563. V0.96ß - (23.12.98) - pierwsza wersja semi-publiczna (dla wybranych testerów)
  564.  
  565. V0.97ß - (1.1.99) zmiany:
  566.  - cache procesora sâ inwalidowane przed wîâczeniem
  567.  - wîâczany jest tylko cache dla instrukcji
  568.  - kod rezydentny sprawdza teraz sumë kontrolnâ Kickstartu (jeôli
  569.    nieprawidîowa, komputer jest resetowany z usuniëciem mapera z pamiëci)
  570.  
  571. V0.973ß - (8.1.99)
  572.  - poprawione rozpoznawanie przez Kickstart pamiëci tzw. slow ($c00000); to
  573.    powino wyeliminowaê zawieszanie sië mapera na niektórych systemach. Dziëki
  574.    dla Arkadiusza Winiarka i Marcina Ostrowskiego za zwrócenie uwagi na ten
  575.    problem.
  576.  
  577. V0.974ß - (12.1.99)
  578.  - po wykryciu procesora 68060, maper ustawia odpowiedniâ flage w strukturze
  579.    biblioteki exec.
  580.  
  581. V0.975ß - (13.1.99)
  582.  - inteligentniejsze rozpoznawanie relokacji przez maper, dziëki czemu moûna
  583.    uûywaê niektórych (dobrze napisanych) programów, które wykorzystujâ wektor
  584.    coldcapture. Pierwsza wersja publiczna.
  585.  
  586. V0.976ß - (26.1.99)
  587.  - zmiana nagîówka mapowanego Kickstartu na 'MM', w celu unikniëcia problemów
  588.    przy próbie ponownego jego zmapowania (RemAPollo dokonuje pewnych zmian w
  589.    obrazie Kickstartu).
  590.  
  591. V0.977ß - (28.1.99)
  592.  - poprawiony bîâd w procedurze resetujâcej.
  593.  
  594. V0.980ß - (1.2.99)
  595.  - dodana moûliwoôê îadowania rezydentnych moduîów (IDEFix, pliki beta od
  596.    Amigi International) razem z Kickstartem.
  597.  
  598. V0.981ß - (4.2.99)
  599.  - usuniëte bîëdy w procedurze alokacji przy opcji MODULES
  600.  
  601. V0.982ß - (5.2.99)
  602.  - maper sprawdza teraz czy nie sa podane te same moduly kilkakrotnie
  603.  - kilka zmian wewnëtrznych
  604.  - dodano nowe pliki do pakietu: LoadResident i KReader
  605.  
  606. Pozostaîa czëôê loga w wersji angielskiej instrukcji.
  607.  
  608. Podziëkowania
  609. -------------
  610.  
  611. Wielkie dziëki Harremu Sintonenowi, który przesîaî mi kilka wstëpnych
  612. informacji dotyczâcych MMU procesora 040. Byîo to dawno temu, ale pomogîy mi
  613. one rozpoznaê problem, z którym zamierzaîem sië zmierzyê.
  614.  
  615. Ciepîe buziaczki dla firmy Motorola ;-) za znakomity dziaî dystrybucji
  616. literatury, który zapewnia wszystkim chëtnym dostëp do szerokiego wyboru
  617. drukowanych materiaîów; a wszystko to caîkowicie za darmo!
  618.  
  619. Wreszcie dziëki wszystkim alfatesterom, którzy zgodzili sië ryzykowaê
  620. stabilnoôê swych systemów, zmagajâc sië z licznymi wresjami pakietu RemAPollo
  621. (szczególnie dziëkujë Marcinowi Ostrowskiemu, który pomógî mi namierzyê bardzo
  622. powaûny bîâd; mam nadziejë, ûe uda Ci sië w koïcu opanowaê system... ;)
  623.  
  624. Specjalne podziëkowania dla Oliviera Fabre za bugreporty i wytrwaîoôê w
  625. testowaniu programu na 68060.
  626.  
  627. Mojemu bratu Jackowi za niniejsze tîumaczenie.
  628.  
  629. Ten program dedykujë Ministry - zespoîowi tworzâcemu muzykë, nie wszechobecne
  630. g...no, jakim jest rap.
  631.  
  632. Autor
  633. -----
  634. Mój adres e-mail (preferowana forma kontaktu): bloelle@priv.gold.pl lub
  635. bloelle@polbox.com
  636.  
  637.  
  638. oraz adres dla zwykîej poczty:
  639.  
  640.                               Mikoîaj Caîusiïski
  641.                             ul. Olsztyïska 113/117
  642.                               42-200 Czëstochowa
  643.  
  644. Mam nadziejë, ûe ten program przyda Ci sië. Baw sië dobrze!
  645.                                                             Mikoîaj.
  646.  
  647.       ------------> AMIGA - NAJLEPSZY KOMPUTER POD SÎOÏCEM <------------
  648.